home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / WEBSITES / FORTRAN_FRIENDS / PNET.ZIP / ReadMe
Text File  |  1999-02-24  |  9KB  |  238 lines
  1.                      !PolyNet (Demo Version)
  2.   'Fortran Friends', P.O.Box 64, Didcot, Oxon, OX11  0TH
  3.               telephone:  +44  (0)  1235  834357
  4.  
  5. Introduction
  6.     !PolyNet is an interactive program which creates planar nets from files
  7. containing data on how to draw polyhedra.  The full version allows you to
  8. save Draw and datafiles; you cannot save any files with this demo version,
  9. you can only use the supplied datafiles, and cannot change the 'Choices' file.
  10.  
  11. Machine and operating system requirements: Any Acorn computers using RISC-OS
  12. operating systems  3.XX, including networks and StrongARM.
  13.  
  14. Copyright and copying: 
  15. This program remains the copyright of 'Fortran Friends'; this demo version
  16. is given to you on the understanding that if you give a copy to anyone else
  17. you will copy all the files, unchanged, including this one.
  18.  
  19. To get the Full Version:
  20.  
  21.  Send a cheque for £20 payable to 'Fortran Friends' at the address above. 
  22.  
  23.   With the full version you can:
  24.  
  25.   1. Save diagrams as 'Drawfiles' and data files for use later.
  26.   2. Use more datafiles: any of the Platonic and Archimedean solids and duals.
  27.   3. Use your own new datafiles
  28.   4. Read more documentaion (see contents of full version directory Docs below)
  29.   5. Send us suggestions for improvements and report problems which we will
  30.       try to correct.
  31.  
  32. --------------------------------------------------------------------
  33.                       Contents of the !PolyNet Demo Disc
  34.                        
  35. Top level directory
  36.  
  37.   !PolyNet application
  38.   Calend99 - a dodecahedron for you to make into a 3D calendar for 1999
  39.   ReadMe (This file)
  40.  
  41.   Examples Directory
  42.    This contains the datafiles. 
  43.  
  44.    Within the !Polynet application, in addition to the usual files, 
  45.    there is a sub-directory 'Docs' which contains some example Drawfiles
  46.  
  47.      Defn     - a Drawfile with an explanatory diagram showing some
  48.                   of the terms used in 'Glossary'
  49.      NetEx1, NetEx2 - two examples of nets saved from !PolyNet
  50.      WorkEx1  - an example of a worksheet for students
  51.  
  52. ------------------------------------------------------------------
  53.        
  54. The rest of this file is the 'ReadMe' from the full version.
  55.  
  56. **************************************************************************
  57.                             !PolyNet
  58.   'Fortran Friends', P.O.Box 64, Didcot, Oxon, OX11  0TH
  59.               telephone:  +44  (0)  1235  834357
  60.  
  61. Introduction
  62.  
  63.     !PolyNet is an interactive program which creates planar nets from files
  64. containing data on how to draw polyhedra, such as that used in !PolyDraw. 
  65.  
  66. Machine and operating system requirements: 
  67.  
  68. Any Acorn computers using RISC-OS operating systems  3.XX, 
  69. including networks and StrongARM.
  70.  
  71. Copyright and copying: 
  72.  
  73. Further details are in the file Docs.CopyRight.
  74. This program remains the copyright of 'Fortran Friends': it is licensed to
  75. you for single use only; you may copy it to a backup floppy disc or to your
  76. own hard disk but giving copies to others is illegal.   Your registration
  77. number is unique; any illegal copies found will be reported to the
  78. 'Federation Against Software Theft' and you will be liable for prosecution.  
  79.  
  80. Getting Started:
  81.  
  82. These instructions assume some knowledge of how to use an Acorn computer. 
  83. If you are a new user, more detailed instructions on how to copy files, use
  84. the windows and the mouse can be found in the 'User Guide' manual for your
  85. computer system. !PolyNet is a RISC-OS compliant program which runs in the
  86. Acorn Desktop and tries to conform to the operating conventions in the Acorn
  87. Style guide; it supports Acorn interactive help.
  88.  
  89. Fortran Friends welcome comments and requests for new features for future
  90. versions of this program. 
  91.  
  92. --------------------------------------------------------------------
  93.                       Contents of the !PolyNet Disc
  94.  
  95. Top level directory
  96.  
  97.   !PolyNet application
  98.   Calend99 - a dodecahedron for you to make into a 3D calendar for 1999
  99.   ReadMe (This file)
  100.  
  101.   Examples Directory
  102.    This contains an index, in file 'ExIndex', to the data files, which make 
  103.    the Platonic and Archimedean solids, their duals and a few others.
  104.  
  105.   Docs Directory 
  106.    Text files
  107.      Activities - some suggested activities to get you started
  108.      BookKits   - suggested reading, and suppliers of model kits
  109.      CopyRight - a statement of 'Fortran Friends' copyright
  110.      FaultRep - a form for you to return if you find any problems
  111.      FormData - a definition of the format of the data files
  112.      Glossary - definitions of terms associated with polyhedra
  113.      Versions - history of changes in previous versions
  114.      WishList - requested improvements
  115.  
  116.    Draw files
  117.      Defn     - a Draw file with an explanatory diagram showing some
  118.                 of the terms used in 'Glossary'
  119.      NetEx1, NetEx2 - two examples of nets saved from !PolyNet
  120.      WorkEx1  - an example of a worksheet for students
  121.               We would be most grateful for copies of further worksheets
  122.               to pass on to other users.
  123.  
  124.  Please send yours and any other suggestions to 'Fortran Friends' 
  125.     at the address above.
  126.   
  127.  --------------------------------------------------------------------
  128.  
  129. Installing !PolyNet
  130.  
  131. 1. Make a working copy on floppy disc. Store the original safely, in case
  132. your working copy becomes damaged. Your license allows you to make a
  133. single copy for your own use. If the disc supplied has been damaged and
  134. will not copy, return it to us for a free replacement within 3 months of
  135. purchase.
  136.  
  137. Use the 'working' copy for the rest of the instructions. You can run from the
  138. floppy if you want to.
  139.  
  140. 2. Installation on hard disc: 
  141. Make yourself a directory for storing your programs, with
  142. a name such as 'Polyhedra' and copy the contents of the floppy disc to it.
  143.  
  144. Note: If you are installing !PolyDraw at the same time, you need not copy
  145. the datafiles supplied in the directory 'Examples' of !PolyNet, since they
  146. are all stored in the sub-directories 'dat0' and 'dat1' of !PolyDraw.
  147.  
  148. 3. Read the Documentation. 
  149. Before trying to run the application, look at the file !Help file for
  150. operating instructions and in the sub-directory 'Docs'  which includes
  151. suggested activities and worksheets, a glossary of terms and example
  152. Draw files.  You may want to print these out for future reference.
  153.  
  154. Operating instructions:
  155. Running instructions are in the file !Help of the application; Acorn
  156. interactive help is supported.
  157.  
  158. Starting the program:
  159.  
  160. 1. Double click on the application !PolyNet to start the program, and load
  161. an icon on to the iconbar. Click the mouse 'MENU' button when the pointer is
  162. over this icon to see the options.  Select 'info' to see the program name,
  163. version number and your registration number, which should be quoted in any
  164. correspondence with 'Fortran Friends'.
  165.  
  166. 2. Drag any of the files from the 'Examples' directory on to the icon to
  167. open a window showing the polyhedron drawn as a 3D solid.  Click with the
  168. 'Select' button over the first face which you want in the planar net. This
  169. opens the 'net' window and shows you that face.  Then click on the next face
  170. you want, which should be adjacent to one of the ones you have drawn
  171. previously. When you have clicked on all the faces a small window appears
  172. allowing you to save a Drawfile. See !Help for further instructions.
  173.  
  174. Stopping the program:
  175. Click 'MENU' over the icon on the iconbar and choose the last option, 'quit'.
  176.  
  177. Displaying your own data files:
  178.  
  179. The format of the data files is defined in the file Docs.FormData which
  180. lists all the possible lines of the file. You need not make all the lines,
  181. but the first line must have the string ':name ' as the 1st 6 characters,
  182. and the last line must begin ':end'.  The faces must be described in
  183. clockwise direction as they are seen from inside the polyhedron. If they are
  184. not, the results are unpredictable, usually, the face is missing from the 3D
  185. plot. 
  186.  
  187. For example:
  188.  
  189. :name my new cube
  190. :comment designed by me on 22 June 97
  191. :solidf 6 4
  192.  4 1 2 3 4 1
  193.  4 4 5 6 1 2
  194.  4 2 1 6 7 7
  195.  4 8 3 2 7 5
  196.  4 8 5 4 3 3
  197.  4 6 5 8 7 4
  198. :solidv    8
  199.    0  0.8 0.58
  200.  -0.8 0 0.58
  201.  0 -0.8 0.58
  202.  0.8 0 0.58
  203.  0.8 0 -0.58
  204.  0 0.8 -0.58
  205.  -0.8 0  -0.58
  206.  0 -0.8 -0.58
  207. :end
  208.  
  209.  
  210. Possible Faults:
  211. Error conditions we have thought about have 'traffic sign' windows which
  212. should allow you to choose whether to stop the program or try to carry on.
  213.  
  214. If your working disc is damaged, you may find when you try to start the
  215. program you merely get an 'error window' saying your user registration file
  216. has been corrupted. Delete all the files from your working disc, and make a
  217. new copy from your original disc. 
  218.  
  219. If you find the program stops in an uncontrolled way, please try to write
  220. down details of what you were doing just before the error, and send them to
  221. us, preferably using the fault report form in file !PolyNet.Docs.FaultRep. 
  222.  
  223. If you have changed any of the !PolyNet files, or the fault is in reading a
  224. new polyhedron of your own, please check carefully that you have listed the
  225. face vertices in the correct order before contacting us. The usual symptom
  226. of this is that the face with incorrect vertices is not plotted in the 3D
  227. window.  Please supply copies of the files on floppy disc which you were
  228. using when the error occurred.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.